---
title: Installation
description: Getting started
---

Install the `nuqs` package with your favourite package manager:

```shell
pnpm add nuqs
```

```shell
npm install nuqs
```

```shell
yarn add nuqs
```

```shell
bun add nuqs
```

## Which version should I use?

| Next.js version range | Supported `nuqs` / `next-usequerystate` version                                                                                                                          |
| --------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| >=14.0.4              | `nuqs@latest`                                                                                                                                   |
| 14.0.3                | `nuqs@latest`, with the `windowHistorySupport` experimental flag, see [#417](https://github.com/47ng/nuqs/issues/417)             |
| 14.0.2                | Not compatible, see issue [#388](https://github.com/47ng/nuqs/issues/388) and Next.js PR [#58297](https://github.com/vercel/next.js/pull/58297) |
| >= 13.1 && \<\= 14.0.1  | `nuqs@latest`                                                                                                                                   |
| < 13.1                | `next-usequerystate@1.7.3`                                                                                                                                    |

<Callout title={<>What happened to `next-usequerystate`?</>}>
It was a mouthful to type, so I decided to abbreviate it to `nuqs`.

The `nuqs` name was introduced in 1.14.0, and `next-usequerystate` will mirror
its versions for the rest of the 1.x.x range. The next major version update
(2.0.0) and subsequent versions will only be published under the `nuqs` name.
</Callout>
